package com.cda.pes.mapper;

import com.cda.pes.pojo.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.Date;
import java.util.List;

/**
 * 用户模块的的持久层接口
 */
@Mapper
public interface UserMapper {
    /**
     * 插入用户的数据
     * @param user
     * @return  受影响的行数（增、删、改都有受影响行数，根据行数判断是否执行成功）
     */
    Integer insert(User user);

    /**
     * 根据用户名来查询用户数据
     * @param username
     * @return  如果找到对应的用户则返回这个用户的数据，如果没有找到则返@null值
     */
    User findByUsername(String username);

    /**
     * 根据用户的uid来修改用户密码
     * @param uid   用户的id
     * @param password  用户的id
     * @param modifiedUser  用户输入的新密码
     * @param modifiedTime  表示修改数据的时间
     * @return  返回值为受影响的行数
     */
    Integer updatePasswordById(Integer uid,
                               String password,
                               String modifiedUser,
                               Date modifiedTime);

    /**
     * 根据用户的id查询用户的数据
     * @param uid   用户的id
     * @return  如果找到则返回对象，反之返回null值
     */
    User findByUid(Integer uid);

    /**
     * 更新用户的数据
     * @param user  用户的数据
     * @return  返回值为受影响的行数
     */
    Integer updateInfoByUid(User user);

    /**
     * @Param("SQL映射文件中#{}占位符的变量名")：解决的问题：当SQL语句的占位符和映射的
     * 接口方法参数名不一致时，需要将某个参数强行注入到某个占位符变量上时，
     * 可以使用@Param("")这个注解来标注映射的关系
     *
     * 根据用户uid修改用户的头像
     * @param uid
     * @param avatar
     * @param modifiedUser
     * @param modifiedTime
     * @return
     */
    Integer updateAvatarByUid(@Param("uid") Integer uid,
                              @Param("avatar") String avatar,
                              @Param("modifiedUser") String modifiedUser,
                              @Param("modifiedTime") Date modifiedTime);

    /**
     * 删除用户（逻辑删除）
     * @param uid   用户id
     * @param modifiedUser  修改者
     * @param modifiedTime  修改时间
     * @return  受影响行数
     */
    Integer deleteUserByUid(Integer uid,
                            String modifiedUser,
                            Date modifiedTime);

    List<User> findAll();
}
